package com.nanhai.buddhist.college.module.study.service.studyplan;

import java.util.*;
import javax.validation.*;
import com.nanhai.buddhist.college.module.study.controller.admin.studyplan.vo.*;
import com.nanhai.buddhist.college.module.study.dal.dataobject.studyplan.StudyPlanSubjectDO;
import com.nanhai.buddhist.college.framework.common.pojo.PageResult;

/**
 * 教学计划课程信息 Service 接口
 *
 * @author xqenzo@163.com
 */
public interface StudyPlanSubjectService {

    /**
     * 创建教学计划课程信息
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createPlanSubject(@Valid StudyPlanSubjectCreateReqVO createReqVO);

    /**
     * 更新教学计划课程信息
     *
     * @param updateReqVO 更新信息
     */
    void updatePlanSubject(@Valid StudyPlanSubjectUpdateReqVO updateReqVO);

    /**
     * 删除教学计划课程信息
     *
     * @param id 编号
     */
    void deletePlanSubject(Long id);

    /**
     * 获得教学计划课程信息
     *
     * @param id 编号
     * @return 教学计划课程信息
     */
    StudyPlanSubjectDO getPlanSubject(Long id);

    /**
     * 获得教学计划课程信息列表
     *
     * @param ids 编号
     * @return 教学计划课程信息列表
     */
    List<StudyPlanSubjectDO> getPlanSubjectList(Collection<Long> ids);

    /**
     * 获得教学计划课程信息分页
     *
     * @param pageReqVO 分页查询
     * @return 教学计划课程信息分页
     */
    PageResult<StudyPlanSubjectDO> getPlanSubjectPage(StudyPlanSubjectPageReqVO pageReqVO);

    /**
     * 获得教学计划课程信息列表, 用于 Excel 导出
     *
     * @param exportReqVO 查询条件
     * @return 教学计划课程信息列表
     */
    List<StudyPlanSubjectDO> getPlanSubjectList(StudyPlanSubjectExportReqVO exportReqVO);

}
